home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 47.7z
/
BS1 part 47
/
ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z
/
ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf
/
apa.lzh.parta
/
hlp_arexx8
< prev
next >
Wrap
Text File
|
1994-03-23
|
21KB
|
903 lines
\ApAssist
\: - This is the Quick Help for the ARexx in IM R/t -
\: ----------------------------------------------------------
\: Written by David E. Patterson
\: ----------------------------------------------------------
\font topaz.font 8
\tc 1
\wr
\lj
\dd "imh_descriptor"
\index "hlp_arexx2/gamma-listreq"
\toc "imh_toc/toc"
\help "aa_help/help
\node "iptofront"
\title "IP to Front"
\next "jackin"
\prev ""
\{ \tc 15 Iptofront \} - Brings the IP screens to the front.
When used as the last command in a script the main panel is activated, just
as if the user clicked in it.
\nw
Usage - '\{ \tc 15 iptofront\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 iptofront\} ';
\endnode
\node "jackin"
\title "Jackin"
\next "killbuff"
\prev "iptofront"
\{ \tc 15 Jackin \} - Returns a single pointer in hexadecimal format.
\{ \tc 15 Jackin \} returns a hexadecimal pointer, which points to the base
of another group of pointers, each of which points to buffer information.
\nw
Usage - '\{ \tc 15 jackin\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 jackin\} ';
jackptr = result;
options;
'backuptoundo';
address command;
'cmpi:myfile '||jackptr;
address(prtnme);
'redraw';
\endnode
\node "killbuff"
\title "Kill Buffer"
\next "lineart"
\prev "jackin"
\{ \tc 15 Killbuff \} - Deletes a buffer.
\nw
Usage - '\{ \tc 15 killbuff <number>\} '
\{ \ts bu Sample Script\} :
options results;
'current';
info = result;
options;
parse var info bname','bnumber','xdim','ydim','xdimydim','memused','
parentname','parentnumber;
'\{ \tc 15 killbuff\} ' bnumber;
\endnode
\node "lineart"
\title "Line Art"
\next "lined"
\prev "killbuff"
\{ \tc 15 Lineart \} - Creates line art from a selected area.
\nw
Usage - '\{ \tc 15 lineart <effect> <threshold> <monochrome>
<blackline>\} '
\{ \tc 15 Effect: 0 - 100%
Threshold: 0 - 255
Monochorome: 0 = No, 1 = Yes
Blackline: 0 = No, 1 = Yes \}
\{ \ts bu Sample Script\} :
'area';
options results;
'askprop Effect: 50 0 100';
effect = result;
'askprop Threshold: 127 0 255';
threshold = result;
'askyn "No Monochrome" "Monochrome"';
mono = result;
'askyn "White Line" "Black Line"';
line = result;
options;
'\{ \tc 15 lineart\} ' effect threshold mono line;
\endnode
\node "lined"
\title "Lined"
\next "linedraw"
\prev "lineart"
\{ \tc 15 Lined \} - Converts image brightness to image thickness.
\nw
Usage - '\{ \tc 15 lined <len>\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 lined 2\} ';
* User Interface: \{ \tc 15 Process Panel
Special Effects
Lined\}
\endnode
\node "linedraw"
\title "Linedraw"
\next "linemode"
\prev "lined"
\{ \tc 15 linedraw \} - Allows you to paint on an image using any of the area
selection modes. This command must be used in conjunction with the stroke
command.
\nw
Usage - '\{ \tc 15 linedraw\} '
\{ \ts bu Sample Script\} :
/* arexx Painting Example */
address('IM_Port');
'newline';
'messagelow "Draw a line for painting"';
'\{ \tc 15 linedraw\} ';
'stroke';
'finish';
\endnode
\node "linemode"
\title "Linemode"
\next "listreq"
\prev "linedraw"
\{ \tc 15 linemode \} - The linemode control is used to specify the draw mode
to be used with the move, draw, and stroke commands. There are 14 brush
modes, including several brush and solid color modes. A mode will remain
current until changed by the user. If no mode is selected, Imagemaster will
default to the mode that is selected in the \{ \ts b Draw Mode \} panel.
\nw
Usage - '\{ \tc 15 linemode <mode>\} '
\wr
The mode can be set to one of 14 different draw modes. These modes are all
assigned a numeric value, as well as a specific name which can be used for
specifying the modes. The modes are as follows:
\nw
\{ \ts b 0 or 'brush' = Brush Draw
1 or 'range' = Use the Current Range
2 or 'tint' = Tint Brush
3 or 'sat' = Saturation Brush
4 or 'bright' = Brightness Brush
5 or 'anti' = Anti-Alias Brush
6 or 'rip' = Remove Isolated Pixels
7 or 'lowpass' = Low Pass Filter Brush
8 or 'sharp' = Sharpen Filter Brush
9 or 'NTSC' = NTSC Preperation Brush
10 or 'rub' = Rub Thru Brush
11 or 'crub' = Chroma Rub Thru Brush
12 or 'lumarub' = Luma Rub Thru Brush
13 or 'absorb' = Absorbing Brush
14 or 'color' = Solid Color Brush\}
\{ \ts bu Sample Script\} :
/* arexx Linemode Example */
address('IM_Port');
options results;
'messagelow "Select an area to be a brush: " ';
'area';
'askstring "Specify a Brush Name:" "Brush1"'new;
new = result;
'clip ' new;
buf = result;
options;
'newbrush ' buf
'newline';
'\{ \tc darkblue linemode 0\} ';
'move 30 30';
'draw 30 30';
'stroke';
'finish';
\endnode
\node "listreq"
\title "List Request"
\next "load"
\prev "linemode"
\{ \tc 15 Listreq \} - Calls a list requester.
Calls a list requester from which the user can select an entry. The selected
item returns a string to the calling ARexx script or .
\nw
Usage - '\{ \tc 15 listreq "Title text",listfile,"keywords,etc"\} '
\{ \ts bu Sample Script\} :
(Fragment)
options results;
'\{ \tc 15 listreq "Launch a P.I. Module","work:mylist.list","load\} ';
name = result;
options;
if name = '' then
do
exit 0;
end;
\endnode
\node "load"
\title "Load"
\next "loadasblend"
\prev "listreq"
\{ \tc 15 Load \} - Loads an image.
Uses the current image path and extension and to load an image.
\nw
Usage - '\{ \tc 15 load <filename>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "Buffername:" "myfile"'name;
name = result;
options;
'\{ \tc 15 load\} ' name;
See Also: \{ \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasblend"
\title "Load as Blend"
\next "loadasbrush"
\prev "load"
\{ \tc 15 Loadasblend \} - Loads a blend
Loads an image file and makes it the blend (alpha) buffer. Uses the current
image path and extension.
\nw
Usage - '\{ \tc 15 loadasblend <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadasblend\} ' name;
See Also: \{ \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasbrush"
\title "Load as a Brush"
\next "loadasprimary"
\prev "loadasblend"
\{ \tc 15 Loadasbrush \} - Loads a brush.
Loads an image file and makes it the brush buffer. Uses the current image
path and extension.
\nw
Usage - '\{ \tc 15 loadasbrush <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadasbrush\} ' name;
See Also: \{ \ts b \link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary" "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadasprimary"
\title "Load as a Primary Buffer"
\next "loadassecondary"
\prev "loadasbrush"
\{ \tc 15 Loadasprimary \} - Loads an image file and makes it the primary.
\nw
Usage - '\{ \tc 15 loadasprimary <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
'\{ \tc 15 loadasprimary\} ' name;
options;
See Also: \{ \ts b \link "loadassecondary " "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
\endnode
\node "loadassecondary"
\title "Load as a Secondary Buffer"
\next "loadimask"
\prev "loadasprimary"
\{ \tc 15 Loadassecondary \} - Loads an image file and makes it the secondary
buffer.
\nw
Usage - '\{ \tc 15 loadassecondary <name>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "myfile"'name;
name = result;
options;
'\{ \tc 15 loadassecondary\} ' name;
See Also: \{ \ts b \link "loadasprimary" "hlp_arexx8/loadasprimary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask" \}
\endnode
\node "loadimask"
\title "Load Image Mask"
\next "loadishape"
\prev "loadassecondary"
\{ \tc 15 Loadimask \} - Loads the valid image area mask from a saved mask
file.
\nw
Usage - '\{ \tc 15 loadimask <path&filename> [mode]\} '
\{ \tc 15 Mode 1 = Replace existing mask (default)
2 = OR
3 = AND
4 = XOR
5 = MINUS\}
\{ \ts bu Sample Script\} :
'\{ \tc 15 loadimask work:images/image.iff\} ';
\endnode
\node "loadishape"
\title "Load IShape"
\next "loadmask"
\prev "loadimask"
\{ \tc 15 Loadishape \} - The loadishpae command allows you to load a new
ishape to be used for area selection or painting. You will need to specify a
complete file name and path for the command to work properly.
\nw
Usage - '\{ \tc 15 loadishape <complete_filename>\} '
\{ \ts bu Sample Script\} :
/* arexx loadishape Example */
address('IM_Port');
'\{ loadishape imimim:ishapes/america.ish\} ';
'ishape 0 0 150 150';
'stroke';
'finish';
\endnode
\node "loadmask"
\title "Load Mask"
\next "loadpal"
\prev "loadishape"
\{ \tc 15 Loadmask \} - Loads a mask for area selection. This command can
replace any other area selection command.
\nw
Usage - '\{ \tc 15 loadmask <complete_filename> [mode]\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 loadmask work:images/mymask.msk \} ';
\{ \tc 15 Mode 1 = Replace existing mask (default)
2 = OR
3 = AND
4 = XOR
5 = MINUS\}
* User Interface: \{ \tc 15 File I/O
Load Mask\}
\endnode
\node "loadpal"
\title "Load Palette"
\next "lockimage"
\prev "loadmask"
\{ \tc 15 Loadpal \} - Loads a previously saved palette.
\nw
Usage - '\{ \tc 15 loadpal <palettename>\} ';
\{ \ts bu Sample Script\} :
'paletteext pa8';
'palettepath work:images';
'\{ \tc 15 loadpal palfile\} ';
'area';
'mappal';
* User Interface: \{ \tc 15 Paint Panel
Adjust Palette
LD Palette\}
\endnode
\node "lockimage"
\title "Lock Image"
\next "lockprimary"
\prev "loadpal"
\{ \tc 15 Lockimage \} - Locks a buffer.
\nw
Usage - '\{ \tc 15 lockimage <buffer number>\} '
\{ \ts bu Sample Script\} :
options results;
'secondary';
buffs = result;
parse var buffs name","number","remainder;
'\{ \tc 15 lockimage\} ' number;
options;
\endnode
\node "lockprimary"
\title "Lock Primary"
\next "locksecondary"
\prev "lockimage"
\{ \tc 15 Lockprimary \} - Locks Primary Buffer.
\nw
Usage - '\{ \tc 15 lockprimary\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 lockprimary\} ';
\endnode
\node "locksecondary"
\title "Lock Secondary"
\next "lowpass"
\prev "lockprimary"
\{ \tc 15 Locksecondary \} - Locks the secondary buffer.
\nw
Usage - '\{ \tc 15 locksecondary\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 locksecondary\} ';
\endnode
\node "lowpass"
\title "Low Pass Filter"
\next "luma"
\prev "locksecondary"
\{ \tc 15 Lowpass \} - The equivalent of an electronic low-pass filter.
\nw
Usage - '\{ \tc 15 lowpass <effect> <direction>\} '
\{ \tc 15 Effect: 0 - 100%
Direction: 1 = horizontal, 2 = vertical, 3 = both\}
\{ \ts bu Sample Script\} :
'area';
options results;
askprop effect 50 0 100;
effect = result;
options;
'\{ \tc 15 lowpass\} 'result;
options results;
'gadgets "Filter","Vertical "Filter" "Horizontal" "Filter","Horizontal and
Vertical"';
direction = result;
options;
'\{ \tc 15 lowpass\} ' effect direction;
See Also: \{ \ts b \link "highpass" "hlp_arexx7/highpass" \}
\endnode
\node "luma"
\title "Luma"
\next "macrodefs"
\prev "lowpass"
\{ \tc 15 Luma \} - Changes the region to luma equivalent B&W.
\nw
Usage - '\{ \tc 15 luma\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 luma\} ';
See Also: \{ \ts b \link "negluma" "hlp_arexx9/negluma"\}
* User Interface: \{ \tc 15 Process Panel
Special Effects
Luma\}
\endnode
\node "macrodefs"
\title "Macro Definitions"
\next "macroext"
\prev "luma"
\{ \tc 15 Macrodefs \} - Returns path and extension of a saved macros.
\nw
Usage - '\{ \tc 15 macrodefs\} '
\{ \ts bu Sample Script\} :
options results;
'\{ \tc 15 macrodefs\} '
info = result;
parse var info path ','extension;
options;
See also: \{ \ts b \link "blenddefs " "hlp_arexx5/blenddefs"
\link "imagedefs " "hlp_arexx7/imagedefs"
\link "palettedefs" "hlp_arexx9/palettedefs"
\link "renderdefs " "hlp_arexx10/renderdefs"\}
\endnode
\node "macroext"
\title "Macro Extension"
\next "macroload"
\prev "macrodefs"
\{ \tc 15 Macroext \} - Sets a new extension for saving and loading macros
files.
\nw
Usage - '\{ \tc 15 macroext <newext>\} '
\{ \ts bu Sample Script\} :
options results;
'askstring "New Extension:" "mac"'name;
name = result;
options;
'\{ \tc 15 macroext\} ' name;
See Also: \{ \ts b \link "blendext " "hlp_arexx5/blendext"
\link "imageext " "hlp_arexx7/imageext"
\link "paletteext" "hlp_arexx9/paletteext"
\link "renderext " "hlp_arexx10/renderext"\}
* User Interface: \{ \tc 15 Setup Panel
Macro Ext \}
\endnode
\node "macroload"
\title "Macro Load"
\next "macropath"
\prev "macroext"
\{ \tc 15 Macroload \} - Loads a Macro file.
\nw
Usage - '\{ \tc 15 macroload <filename>\} ' (without path)
\{ \ts bu Sample Script\} :
options results;
'askstring "File Name:" "macrofile"'name;
name = result;
options;
'\{ \tc 15 macroload\} ' name;
See Also: \{ \ts b \link "blendload " "hlp_arexx5/blendload"
\link "loadasblend " "hlp_arexx8/loadasblend"
\link "loadasbrush " "hlp_arexx8/loadasbrush"
\link "loadasprimary " "hlp_arexx8/loadasprimary"
\link "loadassecondary " "hlp_arexx8/loadassecondary"
\link "loadimask " "hlp_arexx8/loadimask"
\link "loadmask " "hlp_arexx8/loadmask"\}
* User Interface: \{ \tc 15 Macro Panel
Load Macro Set\}
\endnode
\node "macropath"
\title "Macro Path"
\next "mappal"
\prev "macroload"
\{ \tc 15 Macropath \} - Sets the path for loading and saving Macros.
\nw
Usage - '\{ \tc 15 macropath <newpath>\} '
\{ \ts bu Sample Script\} :
'\{ \tc 15 macropath work:macros\} ';
See Also: \{ \ts b \link "blendpath " "hlp_arexx5/blendpath"
\link "imagepath " "hlp_arexx7/imagepath"
\link "palettepath" "hlp_arexx9/palettepath"
\link "renderpath " "hlp_arexx10/renderpath" \}
* User Interface: \{ \tc 15 Setup Panel
Macro Path\}
\endnode
\node "mappal"
\title "Map Palette"
\next "maxmerge"
\prev "macropath"
\{ \tc 15 Mappal \} - Causes selected region to be mapped to the current
palette.
\nw
Usage - '\{ \tc 15 mappal\} '
\{ \ts bu Sample Script\} :
'loadpal palfile';
'area';
'\{ \tc 15 mappal\} ';
* User Interface: \{ \tc 15 Process Panel
Special Effects
Map to Palette\}
\endnode
\node "maxmerge"
\title "Maximum Merge"
\next "maxrub"
\prev "mappal"
\{ \tc 15 Maxmerge \} - Merges where secondary buffer is darker than the
primary buffer.
Merges the secondary buffer into the primary buffer where the color of the
secondary buffer is darker than that in the primary buffer.
\nw
Usage - '\{ \tc 15 maxmerge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 maxmerge\} ';
See Also: \{ \ts b \link "minmerge" "hlp_arexx8/minmerge"
\}
* User Interface: \{ \tc 15 Compose Panel
Linear Compositions
Maximum Merge\}
\endnode
\node "maxrub"
\title "Maximum Rub Thru"
\next "melt"
\prev "maxmerge"
\{ \tc 15 Maxrub \} - Rubs through to primary buffer if the secondary buffer
is darker.
Rubs the secondary buffer through the primar buffer where the color of the
secondary buffer is brighter than the primary buffer.
\nw
Usage - '\{ \tc 15 maxrub\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 maxrub\} ';
See Also: \{ \ts b \link "minrub" "hlp_arexx8/minrub"\}
* User Interface: \{ \tc 15 Compose Panel
Linear Compositions
Maximum Merge\}
\endnode
\node "melt"
\title "Melt"
\next "merge"
\prev "maxrub"
\{ \tc 15 Melt \} - Causes a selected region to appear to be melting.
\nw
Usage - '\{ \tc 15 melt\} '
\{ \ts bu Sample Script\} :
'area';
'melt';
* User Interface: \{ \tc 15 Process Panel
Special Effects
Melt\}
\endnode
\node "merge"
\title "Merge"
\next "message"
\prev "melt"
\{ \tc 15 Merge \} - Merges the secondary buffer into the primary buffer.
\nw
Usage - '\{ \tc 15 merge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 merge\} ';
See Also: \{ \ts b \link "maxmerge " "hlp_arexx8/maxmerge"
\link "minmerge " "minmerge"
\link "combine " "hlp_arexx6/combine"\}
* User Interface: \{ \tc 15 Compose Panel
Linear Compositions
Merge\}
\endnode
\node "message"
\title "Message"
\next "messagelow"
\prev "merge"
\{ \tc 15 Message \} - Presents the user with a message.
Halts script presenting user with a message, when the user clicks on the
message gadget the script resumes.
\nw
Usage - '\{ \tc 15 message <textstring>\} '
\{ \ts bu Sample Script\} :
if flag = 3 then do
'\{ \tc 15 message Warning there is no Secondary Buffer\} ';
exit 0;
End;
\endnode
\node "messagelow"
\title "Messagelow"
\next "minmerge"
\prev "message"
\{ \tc 15 Message \} - Presents the user with a message that is displayed
lower than the \{ \ts b 'message' \} command.
Halts script presenting user with a message, when the user clicks on the
message gadget the script resumes.
\nw
Usage - '\{ \tc 15 messagelow <textstring>\} '
\{ \ts bu Sample Script\} :
if flag = 3 then do
'\{ \tc 15 messagelow Warning there is no Secondary Buffer\} ';
exit 0;
End;
\endnode
\node "minmerge"
\title "Minmerge"
\next "minrub"
\prev "messagelow"
\{ \tc 15 Minmerge \} - Merges where the secondary buffer is brighter than
the primary buffer.
Merges the secondary buffer into the primary buffer where the color of the
secondary buffer is brighter than the primary buffer.
\nw
Usage - '\{ \tc 15 minmerge\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 minmerge\} ';
* User Interface: \{ \tc 15 Compose Panel
Linear Compositions
Minimum Merge\}
\endnode
\node "minrub"
\title "Minimum Rub Thru"
\next "mirror"
\prev "minmerge"
\{ \tc 15 Minrub \} - Rubs through if the secondary buffer is brighter than
the primary buffer.
Rubs the secondary buffer through to the primary buffer where the color of
the secondary buffer is brighter than the primary buffer.
\nw
Usage - '\{ \tc 15 minrub\} '
\{ \ts bu Sample Script\} :
'area';
'\{ \tc 15 minrub\} ';
See Also: \{ \ts b \link "maxrub" "hlp_arexx8/maxrub"\}
* User Interface: \{ \tc 15 Compose Panel
Linear Compositions
Minimum Rub-Thru\}
\endnode
\node "mirror"
\title "Mirror"
\next ""
\prev "minrub"
\{ \tc 15 Mirror \} - Creates mirror images of a selected area.
\nw
Usage - '\{ \tc 15 mirror <direction> <keephor> <keepvert>\} '
\{ \tc 15 Direction: 1 = up, 2 = down, 3 = both
Keep Horizontal: 0 = right, 1 = left;
Keep Veritcal: 0 = up, 1 = down\}
\{ \ts bu Sample Script\} :
'\{ \tc 15 mirror 1 0 1\} ';
* User Interface: \{ \tc 15 Process Panel
Geometric Transformations
Mirror\}
\endnode